home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / MISC / CLVRSTAT / PART1.TXT < prev    next >
Encoding:
Text File  |  1979-12-30  |  2.2 KB  |  42 lines
  1.  
  2.                             README    clvrstat.c v.1.10
  3.                         
  4. This program parses a CLOVER channel status file.  It prompts for the name of the HAL channel
  5. status file to be parsed.  This should have the format nnnnnnnn.tst, where nnnnnnnn is the
  6. input file's time tag.  The input file's first uncommented line should contain the data-
  7. recording station's callsign, and the second uncommented line should contain the remote
  8. station's callsign.  (The HAL software will normally create its *.tst files in this way.) 
  9.  
  10. Output to the console and the file "nnnnnnnn.sum" is various summary statistics calculated 
  11. from the status file.  Output to files called nnnnnnnn.MY and nnnnnnnn.HIS separates the 
  12. input data into space-delimited MY and HIS form suitable for plotting or further analysis.  
  13. The program also makes a total of seven MY and HIS gnuplot setup files.  You can ignore these 
  14. if you don't use gnuplot.  See the October 97 QEX paper for an explanation of the names of 
  15. these setup files and a description of their content.  
  16.  
  17. Preface all comment lines after the first in the HAL input file (as many as you want) with 
  18. a "#" (pound) symbol, which causes Clvrstat to ignore such lines.  Note that most comments 
  19. in the source code use the C++ comment-line marker ("//"), which is accepted by most modern 
  20. C compilers.  If your C compiler doesn't, enclose comments in the usual C comment symbols.
  21.  
  22. Note that the program doesn't have all the crash tests of a commercial application.  
  23. Drive at your own risk! 
  24.  
  25. Executable images of this code for Macintosh (CLVRSTAT_MAC) and DOS (CLVRSTAT.EXE) should 
  26. now also be available at the ARRL site.  CLVRSTAT.EXE should run OK from Windows.
  27.  
  28. Plot-formatting-file names in both Mac and PC versions are now DOS-compatible.  They are:
  29.  
  30. "mysnrtpt.plt"
  31. "hssnrtpt.plt"
  32. "myphsecc.plt"
  33. "hsphsecc.plt"
  34. "mydfreq.plt"
  35. "hsdfreq.plt"
  36. "myhspwr.plt"
  37.  
  38. Note further that the Windows/DOS and Mac versions of gnuplot may use different line- and point-style numbering conventions for formatting plots.  Consult the documentation for your 
  39. version for the appropriate numbers if you want to change the thickness of plot-lines, use different point-symbols, etc.
  40.  
  41. Ken Wickwire, KB1JY.  18 September 1997.
  42.